Usando os relatórios adicionais (do método /project) da API do Tactium MIS

---

Visão geral

Foi disponibilizado um novo endpoint na API do MIS para consulta de dados operacionais através de visões específicas previamente alinhadas com o cliente. Esse endpoint permite o consumo de visões de dados específicas para o projeto, utilizando um mesmo padrão de requisição.

Os dados disponibilizados possuem duas características operacionais importantes:

• Carga diária D-1: os dados são atualizados diariamente com informações referentes ao dia anterior;
• Retenção de dados de 10 dias: apenas os dados dos últimos 10 dias permanecem disponíveis para consulta. Ou seja, qualquer consulta realizada na API retornará somente dados dentro dessa janela de retenção.

Fluxograma

Segue abaixo uma representação do consumo da API MIS do TACTIUM:

1. Aplicação cliente realiza autenticação na API;
2. API retorna o token JWT;
3. Aplicação cliente realiza consulta na API MIS utilizando o token;
4. API retorna os dados da visão solicitada.

Consumo da API

Além dos endpoints já disponibilizados na API do MIS (https://for.tac.tactium.app/MIS/API/Documentation), seguem abaixo as novas visões disponibilizadas.

Importante: o prefixo utilizado na URL pode variar de acordo com o ambiente disponibilizado para o cliente, mantendo sempre o mesmo padrão:

https://<prefixo>.tactium.app/MIS/API/

Exemplo:

https://for.tac.tactium.app/MIS/API/

Autenticação

Antes de consumir qualquer endpoint de consulta, é necessário entender que a API utiliza autenticação via Bearer Token. Portanto, é necessário obter um token de autenticação previamente.

Informações da autenticação

• Endpoint de Login:
  https://for.tac.tactium.app/MIS/API/Login
• Método:
  POST
• Content-Type:
  application/json

Body da requisição

{
  "login": "xxxxx",
  "password": "xxxx"
}

Exemplo de requisição

curl --location 'https://for.tac.tactium.app/MIS/API/Login' \
--header 'Content-Type: application/json' \
--data '{
    "login": "xxxxx",
    "password": "xxxx"
}'

Após autenticação bem-sucedida, será retornado um token JWT. Esse token deve ser enviado no header das requisições subsequentes, independentemente do endpoint consumido.

Exemplo do header Authorization

Authorization: Bearer SEU_TOKEN

Importante: o token possui prazo de expiração de até 10 horas. Após esse período, será necessário gerar um novo token.

Visões específicas

Atualmente, foram disponibilizadas 5 (cinco) novas visões de consulta via API do MIS.

Produto	Type (da API)	Descrição
Tactium Omni	ATVAGTMSG	Visão que apresenta de forma detalhada as atividades de acesso realizadas pelos operadores dentro do OmniPA.
Tactium Omni	CONVBOTTRA	Visão dos atendimentos ocorridos a partir de atendimento humano direto ou assistente virtual (BOT), com ou sem transferência para atendimento humano, apresentando métricas relevantes para avaliar o desempenho dos atendimentos.
Tactium Omni	CONVMSG	Visão que fornece o detalhamento das conversas de mensagens, apresentando as interações e comunicações entre clientes e operadores.
Tactium Omni	PESQCHAT	Visão das respostas da pesquisa de satisfação dos canais digitais, focando no canal de WhatsApp.
Tactium IP	PESQLIG	Visão das respostas da pesquisa de satisfação dos atendimentos de voz.

Padronização das visões

Vale reforçar que todas as visões utilizam:

• Mesmo endpoint;
• Mesmo formato de requisição;
• Mesmo modelo de autenticação.

Consulta das visões

Para realizar o consumo das visões, utilize as informações abaixo.

Informações da requisição

• Endpoint:
  https://for.tac.tactium.app/MIS/API/Project
• Método:
  POST
• Authorization:
  Bearer + Token gerado no endpoint de autenticação
• Content-Type:
  application/json

Estrutura do body

Campo	Tipo	Obrigatório	Descrição
interval	object	Sim	Intervalo de datas da consulta
interval.startDate	datetime	Sim	Data inicial do período
interval.endDate	datetime	Sim	Data final do período
type	string	Sim	Identificador da visão a ser consultada
dynamicFilters	object	Não	Filtros adicionais

Exemplo de body

{
  "interval": {
    "startDate": "2026-05-01T00:00:00",
    "endDate": "2026-05-01T23:59:59"
  },
  "type": "CONVMSG",
  "dynamicFilters": {}
}

Exemplo de requisição

curl --location 'https://for.tac.tactium.app/MIS/API/Project' \
--header 'Authorization: Bearer SEU_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
    "interval": {
        "startDate": "2026-05-01T00:00:00",
        "endDate": "2026-05-01T23:59:59"
    },
    "type": "CONVMSG",
    "dynamicFilters": {}
}'

O retorno da chamada será um objeto JSON contendo as informações do período consultado e disponíveis na base do MIS.

Documentações específicas das visões

Cada visão disponibilizada possui um layout específico de retorno, contendo os campos e regras próprias para interpretação dos dados.

As documentações detalhadas de cada visão, incluindo:

• Descrição dos campos;
• Tipos de dados;
• Regras de preenchimento;
• Exemplos de retorno;
• Observações operacionais;

Serão disponibilizadas separadamente conforme abaixo:

Visão	Documentação específica
ATVAGTMSG	Documento específico da visão ATVAGTMSG
CONVBOTTRA	Documento específico da visão CONVBOTTRA
CONVMSG	Documento específico da visão CONVMSG
PESQCHAT	Documento específico da visão PESQCHAT
PESQLIG	Documento específico da visão PESQLIG

Clique aqui (Mapeamento coluna dos métodos), para os detalhes das documentações.

Boas práticas (recomendadas)

Recomendamos aos responsáveis pelo consumo das APIs a adoção das seguintes práticas:

• Executar as consultas diariamente;
• Consumir os dados sempre dentro da janela de retenção;
• Utilizar intervalos curtos de consulta (preferencialmente 1 dia) para otimizar performance;
• Implementar tratamento para respostas vazias;
• Evitar realizar a mesma consulta repetidas vezes no mesmo dia;
• Após receber as informações da consulta, armazenar os resultados internamente para evitar perdas de dados;
• Implementar controle de expiração do token JWT para evitar falhas de autenticação.